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USERS  GUIDE  FOR  THE  MILSATCOM  LOADING  PROGRAM  'OPAL' 


1 INTRODUCTION. 


1. 1  Background. 

This  report  is  a guide  to  the  use  of  the  OPAL  MILSATCOM 
Loading  Program.  OPAL  is  the  acronym  for  a computer  program,  developed 
for  the  Defense  Communications  Agency  (DCA)  by  ESL  Incorporated,  which 
interfaces  with  the  MILSATCOM  Systems  Office  User  Requirements  Data 
Base  (URDB)  to  provide  summaries  of  satellite  loading  of  selected 
portions  of  that  data  base.  A complete  description  of  OPAL,  in  terms 
of  its  interface  with  the  URDB  and  other  supportive  data  bases,  is 
provided  in  Reference  1. 

OPAL  is  designed  for  use  on  the  IBM  System  370/155  Computer 
at  the  DCEC  Hybrid  Simulation  Facility  (HSF)  and  on  the  IBM  System  360 
Computer  at  DCA  Arlington.  As  such,  this  users  guide  is  applicable 
only  to  operations  at  these  facilities. 

1 . 2  Program  Overview. 

Due  to  the  classified  nature  of  the  URDB  and  other  supportive 
data  bases,  it  is  necessary  that  the  OPAL  Loading  Program  be  run  as  a 
batch  job  during  classified  operations.  However,  to  assist  the  user 
in  setting  up  runs  that  are  both  consistent  and  complete,  a separate 
interactive  computer  program  is  available  and  is  accessed  via  the 
"TSO"  (interactive)  system. 


■''P.D.  Shaft,  "Description  of  the  MILSATCOM  Loading  Program  'OPAL', 

ESL  Incorporated,  Sunnyvale,  CA,  Report  ESL-TM888,  30  September  1977 
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1 . 2  — Continued. 

A simplified  relationship  of  the  interactive  setup  and  batch 
loading  program  is  illustrated  in  Figure  1.  Through  the  interactive 
program  the  user  creates  a dataset  that  contains  sets  of  codes  defining 
various  options  to  be  used  by  the  batch  loading  program.  When  such  a 
dataset  has  been  created,  it  is  then  loaded  onto  magnetic  tape  for 
later  batch  processing. 

The  use  of  OPAL  can  therefore  be  divided  into  two  parts: 
using  the  interactive  program  to  set  up  runs  in  a "codes"  dataset; 
and  running  the  batch  program  to  provide  loading  summaries.  Incidental 
to  these  are  such  operations  as  copying  the  "codes"  dataset  from  TSO 
to  magnetic  tape,  obtaining  compiled  versions  of  the  program  for 
execution,  etc. 

1 . 3  Organization  of  This  Report. 

The  use  of  OPAL  is  described  in  two  sections: 

a.  setting  up  runs  via  TSO; 

b.  processing  runs  on  the  batch  system. 

In  describing  run  setup,  emphasis  is  placed  on  available  commands  and 
options.  The  interactive  program  is  designed  to  provide  necessary 
assistance  to  the  user  and  to  signal  errors  in  usage  as  they  occur. 
Conversely,  the  batch  program  is  invoked  by  a single  "JCL  statement" 
and  the  emphasis  here  is  on  interpreting  the  output.  Incidental 
operations  are  discussed  as  appropriate. 

It  should  be  emphasized  that  this  report  does  not  provide 
a complete  description  of  the  OPAL  computer  program;  that  is  left 
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TSO  OPERATIONS  CLASSIFIED  OPERATIONS 


Figure  1.  Simplified  Operation  of  the  OPAL  Computer  Program 
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2 RUN  SETUP  PROGRAM. * 

2 . 1  Introduction. 

This  section  describes  the  use  of  TSO  and  the  interactive 
computer  program  in  setting  up  runs  for  batch  processing. 

2 . 2  TSO  Procedures. 

All  TSO  commands  necessary  to  obtain  and  execute  the  inter- 
active program  and  to  move  the  resulting  "codes"  file  to  tape  are 
contained  in  a CLIST  (command- list ) dataset,  OPAL.CLIST.  This  subsection 
provides  a step-by-step  guide  to  the  operation  of  the  CLIST. 

2.2.1  STEP  1:  Obtaining  the  CLIST. 

The  TSO  command, 

LISTCAT 

will  indicate  the  presence  of  OPAL.CLIST  in  the  user's  catalog.  If  the 
dataset  is  not  present,  it  may  be  obtained  by  entering  the  TSO  command 
string, 

LBG  OPAL  CLIST  DS (' N800 . LIBRARY ' ) RON 

2.2.2  STEP  2;  Obtaining  the  Interactive  Program. 

The  interactive  program  must  be  present  in  the  user's  catalog 
as  an  executable  dataset,  OPAL. LOAD.  If  the  LISTCAT  command  (issued  in 

* 


The  interactive  Run  Setup  Program  is  available  at  the  HSF  installation 
only;  refer  to  the  OPAL  Final  Report  for  a description  of  batch-job  setup 
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2.2.2 --  Continued. 

STEP  1,  above)  does  not  indicate  the  presence  of  OPAL. LOAD,  the  CLIST 
commands  are  used  to  obtain  it. 

Enter  the  TSO  command  string, 

EXEC  OPAL  ' COMP  BADGE  (badge)  ' 

where  badge  is  a valid  badge  number.  TSO  will  print  several  lines, 
including 


N2770SET  PASSED  TO  BATCH- - 

Dadge  WILL  BE  NOTIFIED  UPON  COMPLETION. 

This  indicate--  that  a ]ob  has  been  submitted  for  batch  processing  to 
create  a load  module.  1 v u.ssag 

IEF404!  N277G.  ..;  L'  I _«=hh. nu...  ss 

indicates  the  job  :s  -te  an<  AD  is  present  in  the  user's 

catalog . 

2.2.3 STEP  J - • ; n ei  • ■ r 


To  access  he  • >r  1 the  purpose  of  setting 

up  runs,  enter  thi 

EXEC  OPAL  ' FKTDI  * 

This  will  result  in  a f ; i: 

program  (operation  within  tr  • t . ■ 

following  subsection) . When  thv  . r • e:  • , 

will  print 
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2.2.3  — Continued. 


EXEC  OPAL  MOVE  TO  PASS  JOB 

TO  CLASSIFIED  SYSTEM  FOR  BATCH  PROCESSING 

as  a reminder  to  transfer  the  control  codes  file  to  magnetic  tape  for 
batch  processing. 

The  interactive  program  may  be  accessed  any  number  of  times 
in  this  manner  and  will  keep  track  of  previously  created  runs. 

Note:  The  message 

OPAL. LOAD  NOT  IN  CATALOG 


indicates  that  the  interactive  program  is  not  present  in  the  user's 
catalog;  return  to  Step  2,  above. 

2.2.4 STEP  4:  Passing  the  Codes  to  Batch. 

When  the  desired  number  of  runs  have  been  set  up  via  the 
interactive  program,  enter  the  TSO  command  string 

EXEC  OPAL  ' MOVE  BADGE  (badge)  ' 

where  badge  is  a valid  badge  number.  TSO  will  print  several  lines, 
including 


N2770MOV  PASSED  TO  BATCH 

badge  VJILL  BE  NOTIFIED  UPON  COMPLETION. 
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2.2.4 — Continued. 

This  indicates  that  a job  has  been  created  and  submitted  for  batch 
processing  to  copy  the  codes  file  from  the  user  catalog  to  magnetic 
tape.  The  message, 

IEF404I  N2770MOV  ENDED  TIME=hh.mm. ss 

indicates  that  the  job  is  completed. 

The  "MOVE"  operation  results  in  the  deletion  of  the  codes 
file  from  the  user  catalog  so  that,  upon  the  next  "SETUP"  operation,  no 
runs  will  be  present  in  the  file.  Note:  The  message 

NO  CODES  TO  BE  PASSED 


indicates  that  no  codes  file  has  been  created  (return  to  Step  3,  above). 

2 . 3 Running  the  Interactive  Program. 

This  subsection  describes  the  use  of  the  interactive  program 
in  setting  up  runs  for  later  batch  processing.  Program  options  are 
defined  in  2.3.1,  while  descriptions  of  the  commands  used  to  assign 
values  to  the  options  are  provided  in  2.3.2.  Several  special  features 
of  the  interactive  program  are  outlined  in  2.3.3,  and  finally,  examples 
of  use  are  given  in  2.3.4. 

2.3.1 Program  Options. 

The  interactive  program  provides  the  user  with  control  of  ten 
program  options,  which  are  grouped  into  the  following  categories: 


C 


0 


k 


ESL-TM887 


2.3.1 — Continued. 

• allocation  control 

• input  sieves 

• satellite  model  identification 

• output  sorts. 

Each  option  is  assigned  a value  by  the  user,  or  in  certain 

cases,  several  values.  Each  option  also  is  uniquely  identified  by  an 
index  number.  The  purpose  of  the  index  numbers  is  described  in  Section 
2.4. 


Descriptions  of  the  options  are  provided  in  the  following 
paragraphs.  A summary  of  the  options  and  allowable  values  appear  in 
Table  1. 

2. 3.1.1  Options  Pertaining  to  Allocation  Control. 

The  loading  algorithm  is  controlled  by  two  options,  type  and 
loading  margin. 

(01)  ALLOCATION  TYPE:  The  user  controls  the  "type"  of 
allocation  to  be  performed.  Options  are  C for  "con- 
strained", and  U for  "unconstrained". 

(02) LOADING  MARGIN (DB) : The  user  specifies  the  value  in 
decibels  of  the  link  margin  the  program  is  to  achieve. 

2. 3. 1.2  Options  Pertaining  to  Input  Sieves. 

Four  input  sieves  are  controlled  by  the  interactive  program. 
Two  additional  input  sieves  are  implicit  by  the  choice  of  satellite, 
described  later:  geometric  (line-of-sight)  and  satellite  name  (Field  P) 
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Table  1.  Summary  of  Interactive  Program  Options 


ESL-TM887 


01 

01 

0 

0 

i 

•H 

•P 

-P 

p 

•H 

r— 1 

4m 

P 

01 

P 

0 

0 

p> 

fd 

e 

•H 

p 

4m 

•H 

P 

0 

0 

4-J 

q< 

01 

Q 

O 

CQ 

O 

H 

q 

9 

rH 

• 

q 

OS 

ro 

rH 

u 

CO 

< 

< 

2 

D 

Q 

«H 

< 

< 

• 

0 

2 

X. 

co 

CN 

H 

rH 

rH 

iH 

m 

rH 

rH 

0 

-p 

<H 

O 

fd 

in 

kO 

in 

rH 

cn 

in 

to 

(1) 

1 

>d> 

cn 

H 

0 

p 

£ 

CO 

P 

G 

in 

O 

r— 1 

p 

0 

•■d 

cn 

P 

rH 

fd 

0 

0 

«. 

4-1 

* 

> 

3 

ro 

•» 

q 

<D 

ro 

P 

-P 

^d 

cn 

ro 

Cm 

P 

rH 

0) 

0 

0 

«. 

* 

CQ 

0 

in 

* 

rH 

cp  xi 

ro 

CN 

CN 

9 

ro 

Cn 

CN 

xi 

0 

O 

•d) 

cn 

2 

Q 

0 

s 

rH 

fd 

■p 

p in 

*» 

H 

D 

-P 

* 

s 

a 

0)  + q 

CN 

rH 

CN 

c 

H 

ro 

rH 

0 

•H 

p) 

cn 

k. 

* 

Q 

•H 

rH 

rH 

D 

e -a  s 

* 

q 

>H 

•» 

w 

CN 

g 

PC 

rH 

q 

Z 

CM 

c cn 

O 

< 

CJ 

< 

C (0  u 

•d) 

•di 

< 

< 

< 

< cn 

< 

rH 

rH 

| 

g 

■P 

•H 

>1 

0 

G 

0 

•H 

Cn 

XI 

■p 

0 

q 

P 

P 

•H 

•H 

0 

fd 

CQ 

m 

CQ 

CQ 

iH 

rH 

■P 

0 

Cn 

E 

q 

q 

y 

9 

0 

rH 

fd 

4J 

rH 

2 

2 

2 

2 

TJ 

0 

u 

fd 

X 

0 

D 

D 

D 

0 

■P 

0 

01 

a 

£ 

fd 

rH 

-P 

G 

•H 

c 

c 

c 

g 

01 

P 

c 

0 

H 

0 

0 

0 

0 

0 

0 

0 

o 

•H 

-P 

0 

■P 

0 

•H 

■P 

TJ 

0 

0 

0 

0 

•H 

P 

•H 

-P 

fd 

<U 

> 

> 

> 

> 

H 

o1 

rH 

■P 

a 

0 

P 

0 

0 

0 

0 

rH 

•H 

rH 

P 

•H 

0 

•H 

•H 

•H 

•H 

•H 

0 

G 

0 

a 

P 

H 

0) 

01 

01 

01 

01 

-p 

P 

■P 

-P 

o 

rH 

0 

fd 

fd 

P 

01 

fd 

TJ 

<d 

fd 

fd 

fd  ^ 

01 

fd 

01 

0 

0 

X 

2 

Q 

01 

01 

01 

w 

01 

Cm 

01 

X 

U1  2 

01 

01 

01 

01 

TO 

0 

01 

0 

0 

0 

<u  _ 

0 

0 

0 

0 

0 

c 

G 

g 

TJ 

G 

TJ 

c 

T3 

c 2 

C 

G rH 

G 

G 

•P 

•H 

H 

•H  ^ 

•H 

ai 

•H  0 

•H 

•H 

G 

4-1 

4-« 

4-1 

0 

4-1 

0 

4-1 

0 

in  Q) 

4-1 

£ 

U-l  T3 

4-1 

4m 

•H 

0 

a) 

0 

•H 

0 

•H 

0 

•H 

<v  V 

0 

fd 

0 0 

0 

0 

P 

Q 

a 

a 

Cm 

a 

Cm 

a 

Cm 

a ^ 

a 

C 

a s 

a 

u 

a, 

cj 

04 

z 

M 

0 

w 

OS 

0 

z 

<* 

cn 

cn 

z 

0 

fri 

w 

w 

H 

5 

H 

0 

2 2 

Q 

2 

q 

Cd 

q 

H 

O CJ 

H 

0 

G 

c 

2 

2 

H 

as 

H Cm 

H 

0 

g 

M 

Cm 

as 

< 

q q 

q 

E-f 

cn 

0 

Q 

y 

0 

2 

< « 

y 

CJ 

< 

H 

-P 

q 

< 

H 

w 

g cu 

2 

a 

CJ 

os 

04 

►j 

Q 

M 

OS 

U 

5 

fX, 

0 

0 

0 

0 

< 

J 

q 

cu 

cn 

q 

2 

s 

cn 

^-N 

✓ — * 

- N 

H 

CN 

m 

rf 

in 

i£> 

r- 

00 

0> 

0 

O 

O 

0 

O 

0 

O 

0 

0 

O 

*H 

ESL-TM887 


2.  3. 1.2  — Continued. 

(03)  TIMEFRAMES : The  user  specifies  a sieve  on  URDB  field  E 
by  entering  allowable  timeframes.  Up  to  three  timeframes 
may  be  entered.  Values  are  C for  "current",  M for  "mid- 
range",  and  L for  "long-range". 

( 04 )  PRIORITIES : The  user  specifies  a sieve  on  URDB  field  F 

by  entering  allowable  priorities.  Up  to  twelve  priorities 
may  be  entered.  Values  are  J1  through  J7,  representing 
joint  priorities,  and  SI  through  S5,  representing  service 
priorities . 

(05)  SCENARIO:  The  user  specifies  a sieve  on  URDB  field  HH  by 

entering  the  single  allowable  scenario.  Values  are  1,2, 

3 and  4,  each  of  which  identifies  a particular  operational 
2 

scenario.  Entering  "ALL"  bypasses  the  SCENARIO  sieve. 

(06)  LOCATION  PREFERENCE:  The  user  controls  a sieve  on  URDB 
field  NN  by  this  option.  Entering  "URDB"  specifies  that, 
for  an  entry  to  be  loaded,  its  preferred  satellite  location 
must  correspond  to  the  satellite  model  location  in  use 
(described  below) . Entering  "ANY"  bypasses  the  LOCATION 
PREFERENCE  sieve. 

2. 3. 1.3  Options  Pertaining  to  Satellite  Model  Selection. 

The  satellite  model  to  be  used  on  a particular  run  is  identi- 
fied by  "name",  model  identification  number  and  gross  location. 


2.  MILSATCOM  Systems  Office,  "Users  Guide  for  Augmentation  of  the 
MILSATCOM  User  Requirements  Data  Base,"  6 June  1977 
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2. 3. 1.3  --  Continued. 

(07)  NAME : The  user  specifies  an  abbreviated  "name"  identify- 
ing the  satellite.  Values  are  AF  for  AFSAT,  D2  for 
DSCS-II , D3  for  DSCS-III  and  FL  for  FLTSAT. 

(08)  MODEL  ID:  The  user  specifies  an  index  that,  combined 
with  NAME  (above) , identifies  a unique  satellite  model  in 
the  Satellite  Model  Data  Base.  Any  integer  value  between 
1 and  99  is  allowed. 

(09 )  LOCATION:  The  user  specifies  which  of  the  four  locations 
in  the  Satellite  Model  Data  Base  is  to  be  used.  Values 
are  A for  Atlantic,  E for  East  Pacific,  I for  Indian 
Ocean  and  W for  West  Pacific. 

2. 3. 1.4  Option  Pertaining  to  Output  Sorts. 

The  selection  of  output  sorts  is  controlled  by  a single  option. 

(10)  OUTPUT  SORTS:  The  user  selects  output  sorts  by  entering 
the  index  of  each  sort  desired.  Indexes  are: 

1 - Line  item 

2 - Submitting  command 

3 - User  community 

4 - WWMCCS/Non-WWMCCS 

5 - Service 

6 - Receive  location 

7 - Receive  terminal  type 

8 - Network 

9 - Priority 

10  - Multiple-access  type 


| 
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2. 3. 1.4  — Continued. 

11  - Type  of  operation 

12  - Country  of  receipt 

13  - Service  availability 

14  - Type  of  service 

15  - Quality  of  service. 

2.3,2 Program  Commands  . 

Definition  of  values  to  the  options  described  in  the  previous 
subsection  is  accomplished  through  the  issuance  of  commands.  Depending 
upon  the  command  issued,  the  program  will  prompt  the  user  for  value 
assignment  to  one  or  more  of  the  program  options.  Additionally,  commands 
are  used  to  obtain  an  output  of  the  current  status  of  the  options,  to 
copy  the  status  of  options  into  the  codes  file  (thereby  "submitting"  a 
run),  to  retrieve  and  delete  previously  submitted  runs,  and  to  terminate 
execution  of  the  program. 

The  program  indicates  that  it  is  ready  to  accept  a command 
by  printing 

COMMAND  READY 

When  a command  is  accepted  and  interpreted,  and  all  operations  dictated 
by  the  command  are  performed,  the  program  returns  to  the  "command  ready" 
state. 

This  subsection  defines  the  various  program  commands.  The 
commands  and  their  meanings  are  summarized  in  Table  2. 
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Table  2 . Program  Commands 


Command 

Action  Taken 

BEGIN 

Initiates  input  sequence  for  control  options 

DELETE 

Deletes  a previously  submitted  run 

END 

Terminates  program  execution 

MODIFY 

Modifies  status  of  selected  option (s) 

RETRIEVE 

Retrieves  a previously  submitted  run 

STATUS 

Prints  status  of  options 

SUBMIT 

Creates  a run  in  the  codes  file 

ESL-TI '887 


2. 3. 2.1  BEGIN  Command. 

The  BEGIN  command  is  used  to  initiate  an  input  process  in 
which  each  of  the  options  in  Table  1 is  assigned  a value.  As  one  option 
is  assigned,  the  next  option  automatically  is  prompted. 


When  multiple  values  are  entered,  the  values  are  separated 
by  commas.  If  an  error  occurs,  the  program  will  indicate  the  erroneous 
input  and  re-request  the  option.  An  attempt  to  enter  more  than  the 
maximum  number  of  values  (indicated  in  Table  1)  results  in  a warning 
that  extraneous  values  are  ignored. 


A carriage  return  following  the  prompt  will  result  in  a 
default  value  being  assigned  to  the  option,  as  indicated  in  Table  1. 

When  the  tenth  option  has  been  assigned,  the  program  returns 
to  the  "command  ready"  state. 

2. 3. 2. 2 DELETE  Command. 

The  DELETE  command  is  used  to  delete  a run  that  was  previously 
created  by  a SUBMIT  command  (see  2. 3. 2. 7).  When  DELETE  is  issued  the 
program  will  request  the  number  of  the  run  to  be  deleted.  If  the  run 
number  entered  corresponds  to  a previously  submitted  run,  that  run  will 
be  deleted  from  the  codes  file  (and  bypassed  by  the  Loading  Program) 
and  the  program  will  print 

***RUN  # n DELETED  . 

If  the  run  number  specified  does  not  correspond  to  a previously 


submitted  run,  the  program  will  signal  the  error  and  return  to  "command 
ready”  state  with  no  further  action. 


ESL-TM887 


2. 3. 2. 3 END  Command. 

The  END  command  is  used  to  terminate  execution  of  the  inter- 
active program.  Control  will  be  returned  to  TSO. 

2. 3. 2. 4 MODIFY  Command. 


The  MODIFY  command  is  used  to  initiate  an  input  process  in 
which  selected  options  are  assigned  values.  The  program  first  requests 
the  indexes  of  the  options  to  be  modified.  Indexes  may  be  entered  in 
any  order,  separated  by  commas;  an  invalid  index  will  result  in  termin- 
ation of  the  "modify"  operation. 

The  program  then  prompts  for  each  of  the  options  that  were 
selected  for  modification.  As  one  option  is  assigned,  the  next  is 
automatically  prompted. 

When  multiple  values  are  entered,  the  values  are  separated 
by  commas.  If  an  error  occurs,  the  program  will  indicate  the  erroneous 
input  and  re-request  the  option.  An  attempt  to  enter  more  than  the 
maximum  number  of  values  (indicated  in  Table  1)  results  in  a warning 
that  extraneous  values  are  ignored. 

A carriage  return  following  the  prompt  will  result  in  a 
default  value  being  assigned  to  the  option,  as  indicated  in  Table  1. 

When  the  last  specified  option  has  been  assigned,  the  program 
returns  to  the  "command  ready"  state. 

2. 3. 2. 5  RETRIEVE  Command. 


The  RETRIEVE  command  is  used  to  retrieve  a run  that  was 
previously  created  by  the  SUBMIT  command  (see  2. 3. 2. 7).  When  RETRIEVE 
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2. 3. 2. 5 — Continued. 

is  issued  the  program  will  request  the  number  of  the  run  to  be  retrieved. 
If  the  run  number  entered  corresponds  to  a previously  submitted  and 
undeleted  run,  that  run  will  be  retrieved  from  the  codes  file;  i.e., 
the  internal  status  of  the  control  options  will  be  set  to  their  status 
in  the  "retrieved"  run;  the  program  will  then  print 

* * *RUN  # n RETRIEVED. 

If  the  run  number  specified  does  not  correspond  to  a pre- 
viously submitted  run,  the  program  will  signal  the  error  and  return  to 
"command  ready"  state  with  no  further  action. 

NOTE 

The  STATUS  command  (described  next)  may  now  be  used 
to  list  the  status  of  the  retrieved  run. 


2. 3. 2. 6 STATUS  Command. 

The  STATUS  command  is  used  to  obtain  the  internal  status  of 
all  control  options. 

NOTE 

The  STATUS  command  may  be  used  in  conjunction  with 
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2. 3. 2. 7 SUBMIT  Command. 

The  SUBMIT  command  is  used  to  create  a copy  of  internal  option 
status  in  the  codes  file,  thereby  submitting  a run.  The  date  and  time, 
indicated  at  the  initiation  of  the  interactive  program,  also  are  stored 
in  the  codes  file. 

When  a run  is  submitted,  it  is  assigned  an  identifying 

number : 

***SUBMITTED  AS  RUN  NUMBER  n. 

This  run  number  will  appear  on  the  output  of  the  batch  loading  program 
to  identify  this  particular  run.  The  date  and  time  the  run  was  sub- 
mitted also  will  appear  as  further  identification  of  the  run. 

A maximum  of  twenty  runs  may  be  submitted  in  this  manner; 
to  submit  more  than  this  number  is  an  attempt  to  exceed  the  capacity  of 
the  codes  file  and  results  in  an  error  message. 


2.3.3 Special  Features. 

Several  features  are  available  that,  under  certain  circum- 
stances, could  be  beneficial  to  the  user. 

OBTAINING  HELP:  Enter  a question  mark  (?)  after  any  request 
for  input  (including  "command  ready")  to  obtain 
instructions  for  valid  input. 


THIS  PAGE  IS  BEST  QUALITY  PRACTICABLE 
nS0M  COP  I FURNISHED  TO  DDC 
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2.3.3  — Continued. 

RETURN  TO  "COMMAND  READY":  Enter  the  character  string  "ABORT" 
after  any  request  for  input  to  return  to  the  "command 
ready"  state. 

IMMEDIATE  PROGRAM  TERMINATION:  Enter  end-of-file  characters 

(/*)  after  any  request  for  input  to  immediately  terminate 
execution  of  the  interactive  program  and  return  to  TSO 
(runs  submitted  during  that  execution  are  lost) . 

2.3.4  Interactive  Program  Examples 

Example  1:  Accessing  the  interactive  program. 

This  example  illustrates  the  manner  in  which  the  interactive 
program  is  accessed  from  TSO.  A LISTCAT  command  first  is  issued  to  TSO 
to  verify  that  the  program  (OPAL. LOAD)  is  present  in  the  user's  catalog. 
The  EXEC  command  is  then  issued,  invoking  the  program.  Note  that 
messages  printed  upon  program  initiation  indicate  that  four  runs  are 
present  in  the  Control  Codes  File.  User  inputs  are  underlined. 


LISTCRT 


BphL.clist 


OPAL. LOAD 
PEABY 


EXEC  OPAL  '•SETUP" 


♦♦♦OPAL  AT 
< 4 PUNS 


1 : 02  ON  15  OCT  ??♦♦♦ 
SUBMITTED  TO  DATE) 
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assigning  values  to  all  program  options. 


COMMAND  READY 
BEGIN 

♦♦♦ALLOCATION  CONTROL ♦♦♦ 

COO  ALLOCATION  TYPE: 

C 

C02>  LOADING  MARGIN  <DB>  : 

1.5 

♦♦♦INPUT  SIEVE  CONTPOL^^ 

C03>  TIMEFRAMES: 

L>  M 

C 04>  PRIORITIES: 

J1-.  J5f  SI 

Ci5>  SCENAR 1 0 : 

C06>  LOCATION  PREFERENCE: 
IJRDB 

♦♦♦SATELL I TF  I DENT  I F I CAT  I ON^* 
C 07)  NAME: 

AF 

C0©>  MODEL  ID: 

£ 

<09>  LOCATION: 

E_ 

♦♦♦OUTPUT  SORT  CONTROL^^ 


< 1 0>  SORTS: 
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2.3.4  — Continued. 


Example  3;  STATUS  Command. 


The  use  of  the  STATUS  command  is  illustrated  in  this  example. 


COMMAND  READY 

STATUS 

♦♦♦ALLOCATION  CDNTROL^^ 

(01)  RLLDCRT ION  TYPE:  C 

C02>  LOADING  MARGIN  <DB>  : 1.50 

♦♦♦INPUT  SIEVE  CONTROL^* 

<03>  TIMEFPRMES:  M L 
(04)  PRIORITIES:  J1  J5  SI 
< 05 > SCENRRID:  3 
<06>  LOCATION  PREFERENCE:  URDB 

♦♦♦SATELLITE  MODEL  IDENTIFICATION^^ 
< 07)  NAME:  RF 
<08>  MODEL  ID:  2 
< 09)  LOCATION:  E 

♦ ♦♦OUTPUT  SORT  CONTPOL^^ 

(10)  SORTS:  1 3 4 


Example  4;  SUBMIT  Command. 


The  use  of  the  SUBMIT  command  is  illustrated  in  this  example. 
Note  that  the  run  submitted  will  be  identified  as  Run  #5,  submitted  at 
1:02  on  15  Oct.  1977  (the  time  and  date  printed  upon  program  initiation) 
on  the  output  of  the  loading  program. 


COMMAND  READY 
SUEM I T 

♦♦♦SUBMITTED  AS  RUN  ::  • 5 
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2.3.4  — Continued. 


Example  5:  MODIFY  Command. 


In  this  example,  the  MODIFY  command  is  used  to  modify  selected 
options.  A SUBMIT  command  then  is  issued  to  enter  a run  into  the  Control 
Codes  File. 


CDMMAND  READY 
MODIFY 

LIME  MUMPERS: 

1 « 7 n 8 

0 1 > ALLOCATION  TYPE: 

y_ 

<07>  MAME : 

D3 

<08>  MODEL  ID: 

1_ 

COMMAND  READY 
SUBMIT 

♦♦♦SUBMITTED  AS  RUM  “ 6 


Example  6: RETRIEVE  Command . 


In  this  example  the  RETRIEVE  command  is  used  to  retrieve  the 
status  of  a previously  submitted  run.  A subsequent  STATUS  command  lists 
the  status  of  the  options,  indicating  the  status  of  the  retrieved  run. 
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2.3.4  — Continued. 


COMMAND  READY 
RETRIEVE 

RIJN  NUMBER: 

£ 


♦♦♦RUN  NUMBER  £ RETRIEVED 

COMMAND  READY 

STATUS 


♦♦♦ALLOCATION  CONTROL^^ 

<01>  ALLOCATION  TYPE:  C 

<0£>  LOADING  MARGIN  <DB>  : 3.00 


♦♦♦INPUT  SIEVE  CONTROL^^ 

< 03>  TIMEFRAMES:  C M L 

< 04)  PRIORITIES:  J1  J£  J3  J4  J5  JG  J7  SI  S£  S3  S4  S5 
<05>  SCENARIO:  ALL 
< 06)  LOCATION  PREFERENCE:  ANY 


♦♦♦SATELLITE  MODEL  IDENTIFICATION^-*^ 
(07)  NAME:  D3 
<08>  MODEL  ID:  1 
< 09>  LOCATION:  A 


♦♦♦OUTPUT  SORT  CONTROL^* 

(10)  SORTS:  1 £ 3 4 5 6 


7 S 
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Example  7:  DELETE  Command. 


In  this  example,  the  DELETE  command  is  used  to  delete  a 
previously  submitted  run  from  the  Control  Codes  File. 


COMMAND  READY 
DELETE 

RUN  NUMBER: 

£ 


♦♦♦RUN  NUMBER 


£ DELETED 
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2.3.4  — Continued. 


Example  8 : END  Command. 


In  this  example,  the  END  command  is  issued  to  terminate  the 
interactive  program  and  return  control  to  TSO.  Note  that  the  messages 
printed  upon  termination  indicate  that  there  are  now  six  runs  in  the 
Control  Codes  File  (including  those  that  were  deleted) . The  "READY" 
line  indicates  that  control  has  been  returned  to  TSO. 


COMMAND  READY 
END 


♦♦♦  6 RUNS  SUBMITTED — END  OF  JOB 

RERDY 
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3.  BATCH  LOADING  PROGRAM. 


3.1  Introduction . 


This  section  describes  the  use  of  the  batch  MILSATCOM  Loading 
Program.  Controlled  by  the  codes  created  during  interactive  run  setup 
(described  in  the  previous  section) , the  batch  program  accesses  the 
URDB  and  other  supportive  datasets  to  provide  summaries  of  satellite 
loading. 


Submission  of  the  batch  program  for  execution  is  straight- 
forward, and  as  such  the  emphasis  on  this  section  is  on  the  interpre- 
tation of  its  output.  A brief  discussion  of  batch  job  submission  is 
provided  in  Subsection  3.2. 

3 . 2 Batch  Job  Submission. 

The  OPAL  MILSATCOM  Loading  Program  is  run  in  batch  during 
classified  operations.  The  lengthy  JCL  (Job  Control  Language)  necessary 
for  coordinating  the  supportive  datasets  (stored  on  tape)  and  the  control 
codes  (created  during  interactive  setup  and  passed  to  a separate  tape) 
is  contained  in  a cataloged  procedure  dataset.  The  only  JCL  required 
to  submit  the  batch  job  therefore  consists  of  a JOB  statement,  an  EXEC 
statement  and  a null  (end-of-job)  statement. 

The  overall  job  consists  of  first  copying  the  codes  file  and 
all  supportive  datasets  from  tape  to  temporary  disk  datasets,  and 
finally  executing  the  loading  program.  Under  normal  circumstances, 
system  utility  output  created  by  the  six  tape-copy  operations  is 
suppressed,  while  OPAL-generated  diagnostic  messages  are  printed.  In 
such  circumstances,  the  following  JCL  is  submitted: 
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3.2 

— 

Continued. 

// 

JOB 

// 

EXEC  OPAL 

// 

To  suppress  diagnostics  generated  by  the  program,  the  EXEC 
card  becomes: 

//  EXEC  OPAL, MSGS=' DUMMY, ' 

To  obtain  messages  generated  by  the  tape-copy  operations,  code 
//  EXEC  OPAL , GENOUT= 

Finally,  to  suppress  OPAL-generated  diagnostics  and  obtain 
tape-copy  messages,  code: 

//  EXEC  OPAL, GENOUT=,MSGS=' DUMMY, ' 

3 . 3 Batch  Job  Output. 

Batch  job  output  consists  of  four  parts: 

a.  JCL  and  system  messages; 

b.  ESOGENER  utility  (tape-copy)  messages; 

c.  OPAL-generated  loading  summaries; 

d.  OPAL-generated  diagnostics. 

3.3.1 System  Messages. 

System  messages  appear  at  the  front  of  the  job  output. 

The  termination  codes  of  each  job  step,  as  well  as  step  and  job  CPU 
times,  are  indicated  therein. 
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3.  3.1 


— Continued. 


The  batch  loading  job  consists  of  the  following  job  steps: 


Step  Name 

UNLOAD 10 


Function 


Copies  codes  file  from  tape  to  disk 


UNLOAD 11 


UNLOAD 12 


Copies  terminal  locations  data  base  from  tape 
to  disk 

Copies  terminal  types  data  base  from  tape 
to  disk 


UNLOAD 13 


Copies  URDB  from  tape  to  disk 


UNLOAD 14 


Copies  URDB  augmentation  from  tape  to  disk 


UNLOAD 15 


Copies  satellite  data  base  from  tape  to  disk 


RUNLOAD 


Executes  loading  program. 


Each  of  the  "UNLOADnn"  steps  must  terminate  with  a condition 
code  of  0000  in  order  for  the  RUNLOAD  step  to  execute.  If  a nonzero 
condition  code  is  present,  an  error  has  occurred  in  the  copy  operation 
performed  by  that  step;  coding 


//  EXEC  OPAL , GENOUT= 


on  the  subsequent  job  submission  will  provide  further  diagnostic 
information  (see  Subsection  3.2). 
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3.3.1  — Continued. 

A termination  code  of  other  than  0000  in  the  RUNLOAD  step 
indicates  abnormal  program  termination.  If  this  occurs,  all  output 
should  be  saved  in  order  that  the  cause  may  be  determined. 

'ft 

3.3.2  ESOGENER  Messages. 

ESOGENER  (tape-copy)  messages  normally  are  suppressed. 

The  user  should  refer  to  Subsection  3.2  for  instructions  on  obtaining 
the  ESOGENER  messages,  and  to  an  appropriate  Utility  User's  Guide  for 
instructions  on  interpreting  the  messages. 

3.3.3  Loading  Program  Output  . 

The  output  of  the  Loading  Program  consists  of  the  various 
runs  defined  by  the  user  during  interactive  run  setup.  Each  run  con- 
sists of  those  sorts  that  were  selected  for  display  for  that  run.  In 
addition,  each  run  contains  a "header",  comprised  of  a listing  of 
options  in  effect  for  that  run,  and  a summary  of  satellite  transponder 
resource  utilization.  Finally,  indexes  are  printed  both  at  the  end  of 
each  run,  indicating  the  page  number  of  each  sort,  and  at  the  end  of 
each  job,  indicating  the  page  number  of  each  run. 

Figure  2 illustrates  the  format  of  the  run  "header".* 

Controlling  options  are  printed  in  a sequence  similar  to  that  used 

♦ 


*To  illustrate  the  program  output  formats,  a sample  case  was  run.  The 
simulated  URDB  and  other  supportive  datasets  were  based  on  a 161-access 
data  base  developed  by  Stanford  Telecommunications,  Incorporated  for 
the  Real-Time  Adaptive  Control  System  (RTACS)  study  (R.  Alvarez, 

"Dynamic  Traffic  Model",  Stanford  Telecommunications,  Incorporated). 

i 
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Figure  2.  Format  of  the  Run  "Header" 


3.3.3  — Continued. 


during  interactive  run  setup.  In  addition  to  the  run  number  (at  the 
top  of  the  page)  the  time  and  date  of  submission  are  provided  for 
identification.  The  transponder  resource  utilization  summary  ("XPNDR") 
provides  totals  of  power,  EIRP,  bandwidth  and  data  rate  per  transponder. 


Figure  3 illustrates  the  format  of  the  line-item  ( "LINEITEM" ) 
sort.  Individual  categories  represent  concatenations  of  URDB  fields 
A and  B,  therefore  defining  individual  entries  in  the  URDB. 
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Figure  3 
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3.3.3 — Continued. 

Figure  4 illustrates  the  format  of  the  submitting-command 
("ORIGIN")  sort.  Individual  categories  correspond  to  entries  in  URDB 
field  A. 

Figure  5 illustrates  the  format  of  the  user-community  ("USER") 
sort.  Categories  A,  C,  D,  F,  G,  I,  N,  S,  and  U correspond  to  entries  in 
URDB  field  V,  while  Z is  a program-generated  default  category. 

Figure  6 illustrates  the  format  of  the  WWMCCS/Non-KWMCCS 
( "WMCS/NON" ) sort.  The  individual  categories  correspond  to  entries 
in  URDB  field  Q. 

Figure  7 illustrates  the  format  of  the  service  ("SERVICE" ) 
sort.  The  individual  categories  correspond  to  entries  in  URDB  field  II. 

Figure  8 illustrates  the  format  of  the  receive-location 
("REC.  LOC")  sort.  Those  categories  not  prefixed  by  an  asterisk  (*) 
are  fixed-platform  locations  based  on  look-ups  from  the  Earth  Terminal 
Locations  Data  Base,  from  information  in  URDB  field  FF  (when  a duplex 
access  is  generated  field  DD  additionally  is  used).  The  *RGN00,  *RGN01, 
*RGN03,  *RGN04,  *RGN05  and  *RGN06  categories  are  mobile-platform 
locations  corresponding  to  URDB  field  H-3  designations  of  0,  1,  2,  3, 

4,  5 and  6,  respectively.  The  *NB  category  is  a program-generated 
default  location. 

Figure  9 illustrates  the  format  of  the  receive-terminal-type 
("TERMTYPE")  sort.  Two-digital  categories  (01,  11,  etc.)  correspond  to 
entries  in  URDB  field  EE  (when  a duplex  access  is  generated  field  CC 
additionally  is  used).  Three-digital  categories  (101,  102,  103,  201,  202, 
203)  are  program-generated  default  terminal  types.  Assignment  of  a line 
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Figure  4.  Format  of  the  Submitting-Command  Sort 
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Figure  5.  Format  of  the  User-Community  Sort 
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3.3.3 


— Continued. 


item  to  a default  terminal  type  is  based  on  URDB  fields  H-3  (platform 
type)  and  P (satellite)  as  follows:* 


Field  P 

Field  H-3 

Type 

EIRP 

(dBW) 

G/T 

(<2B) 

AF,  FL 

F 

101 

29 

-13 

B,  T,  V,  X 

1 02 

26 

-20 

A,  P,  S 

103 

17 

-30 

D2 , D3 

F 

201 

97 

39 

B,  T,  V,  X 

202 

70 

18 

A,  P,  S 

203 

72 

7 

Figure  10  illustrates  the  format  of  the  network  ("NET  NAME") 
sort.  The  individual  categories  correspond  to  entries  in  URDB  field  D. 

Figure  11  illustrates  the  format  of  the  priority  ("PRIORITY") 
sort.  Categories  Jl,  J2,  J3,  J4,  J5,  J6,  J7,  SI,  S2,  S3,  S4  and  S5 
correspond  to  entries  in  URDB  field  F.  Category  X is  a program-generated 
default  category. 


♦Refer  to  the  OPAL  Final  Report  ESL-TM888  for  a complete  description  of 
default  terminal- type  assignments. 
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Figure  8.  Format  of  the  Receive-Location  Sort 
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Figure  9.  Format  of  the  Receive-Terminal-Type  Sort 
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Figure  10.  Format  of  the  Network  Sort 
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Figure  11.  Format  of  the  Priority  Sort 


3.3.3  — Continued. 


Figure  12  illustrates  the  format  of  the  multiple-access-type 
("MULT  ACC")  sort.  Categories  SSMA,  FDMA  and  TDMA  correspond  to  entries 
of  S,  F,  and  T,  respectively,  in  URDB  field  MM. 


Figure  13  illustrates  the  format  of  the  type-of-operation 
("TYPE  OP")  sort.  Individual  categories  correspond  to  entries  in  URDB 
field  K. 


Figure  14  illustrates  the  format  of  the  country-of-receipt 
("RCOUNTRY")  sort.  Individual  categories  correspond  to  entries  in 
URDB  field  H-l  (when  a duplex  access  is  generated,  field  G-l  addition- 
ally is  used) . 

Figure  15  illustrates  the  format  of  the  service-availability 
( " SERV  AVL" ) sort.  Individual  categories  correspond  to  entries  in 
URDB  field  L. 


Figure  16  illustrates  the  format  of  the  type-of-service 
("TYPE  SVC")  sort.  Individual  categories  correspond  to  entries  in 
URDB  field  I. 
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Figure  15.  Format  of  the  Service-Availability  Sort 
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Figure  16.  Format  of  the  Type-of-Service  Sort 


3.3.3 — Continued. 


Figure  17  illustrates  the  format  of  the  quality-of-service 
("QUAL  SVC")  sort.  Individual  categories  correspond  to  entries  in 
URDB  field  M. 


Finally,  Figures  18  and  19  illustrate  the  formats  of  the 
indexes  to  sorts  and  runs.  As  previously  mentioned,  the  sort  index 
appears  at  the  end  of  each  run,  and  the  index  to  runs  appears  at  the 
end  of  the  job  output. 
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Figure  17.  Format  of  the  Quality-of-Service  Sort 
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3.3.4 Program-Generated  Diagnostic  Messages. 


OPAL  generates  several  types  of  diagnostic  messages  to  warn 
the  user  of  default  actions  taken  by  the  program.  These  messages, 
grouped  according  to  run  number,  normally  appear  as  the  last  set  of 
output  in  a job  listing,  but  may  be  suppressed  (by  proper  JCL,  as 
indicated  earlier  in  this  Section) . A sample  diagnostic-message  set 
is  provided  in  Figure  20.  The  possible  messages  and  their  significance 
are  described  below. 


MESSAGE:  DEFAULT  ASSIGNMENT  MADE  TO  FIELD  ff  OF  URDB  ENTRY  aaabbb 

MEANING:  Field  ff  of  the  URDB  or  Augmentation  entry  whose  "A"  and  "B" 

fields  contain  aaa  and  bbb,  respectively,  was  in  error  and  a 
default  value  was  assigned. 


MESSAGE:  CULLED  URDB  ENTRY  aaabbb  FOR  ERROR  IN  FIELD  ff 

MEANING:  Field  ff  of  the  URDB  of  Augmentation  entry,  whose  "A"  and  "B" 

fields  contain  aaa  and  bbb  respectively,  was  in  error  and 
the  entry  therefore  was  culled. 


MESSAGE:  LOCATIONS  ENTRY  ttt...ttt 

MEANING:  The  entry  in  the  Locations  Data  Base  containing  text  ttt... 

ttt  was  in  error  and  therefore  not  loaded  into  the  program. 
Any  line  items  referencing  this  location  therefore  were 
assigned  to  a default  location. 


MESSAGE:  ATTEMPT  TO  EXCEED  MAXIMUM  NUMBER  OF  LOCATIONS 


MEANING:  The  Locations  Data  Base  contained  more  than  the  maximum  92 

entries  allowed.  Additional  entries  were  not  loaded  into 
the  program;  any  line  items  referencing  such  a location 
therefore  were  assigned  to  a default  location. 


MESSAGE:  TERM  TYPES  ENTRY  ttt... ttt  CULLED 

MEANING:  The  entry  in  the  Terminal  Types  Data  Base  containing  text 
ttt... ttt  was  in  error  and  therefore  not  loaded  into  the 
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Figure  20.  Sample  Diagnostic  Output 


41 


ESL-TM887 


MESSAGE: 

MEANING: 

MESSAGE : 
MEANING: 

MESSAGE: 

MEANING: 


— Continued. 


program.  Any  line  items  referencing  this  terminal  type 
therefore  were  assigned  to  a default  terminal  type. 


ATTEMPT  TO  EXCEED  MAX  NUMBER  OF  TERM  TYPES 

The  Terminal  Types  Data  Base  contained  more  than  the  maximum 
44  entries  allowed.  Additional  entries  were  not  loaded  into 
the  program;  any  line  items  referencing  such  a terminal 
therefore  were  assigned  to  a default  terminal  type. 


UPLINK  POWER  IN  TRANSPONDER  xx  BELOW  vvv.vvv  DBW 

The  total  received  signal  power  at  the  input  to  transponder 
xx  was  less  than  the  warning  threshold,  vvv.vvv  dBW,  assigned 
to  the  transponder  in  the  Satellite  Model  Data  Base. 


ERROR  NUMBER  n IN  SATELLITE  DATA  BASE — RUN  NUMBER  r TERMINATED 

An  error  was  detected  in  the  Satellite  Model  Data  Base  for 
which  there  is  no  default  action.  Run  number  r therefore 
was  terminated,  and  the  program  proceeded  with  the  next  run 
(if  any) . Refer  to  Table  3 for  a description  of  the 
satellite  error  code,  n. 
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Code 


Meaning 
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